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GENERAL QESCRIPTION 


INTERP/MONITOR is a program which formats and orints tables 
containing S~op frequency and execution times for 91800/81700 
S"machinese The information is gathered by means of a special 
interpreter which dynamically stores it in-a table in memory. 
Most 81890/31700 interpreters have the required code maintained 
in the source files but conditionally excluded from the object in 
retease interpreters. 


RELATEO DOCUMENTATION: | 


Name Number 

 91800/81700 Software Operational Guide 1068731 
B1R00/81700 MCPII | Pe Se 2212 5462 
B1890/B17006 MCP Control Syntax Pe Se 2219 O144 
B1800/8170C SDL (BNF Version) Ps Se 2212 5405 


BL800/B1700 SDL S-Language | Pe Se 2201 2389 
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SOFTWARE REQUIREMENTS 


on re eee ee oie 


INTERP/MONITOR requires a special interpreter which is a standard 
SDL interpreter with the inclusion of a special op which is used 
to ckhear the GISMO traca table to zeros in response to the 
following user inpute 


<job=-number>AX CLEAR 


The special operator is invoked by INTERP/MCOCNITOR by using the 
SDL EXECUTE operator. parameters the number of bits to be 
cleared in the GISMO trace tables is passed to the interpreter 
via the SDL EVALUATION stack. 


Note: SOLSMONTTOR and I-NTERP/MONITOR were both compiled in the 
past and are matched to each other.. If one of these 15 
recompiled» the other must be recompiled atsa. Both the 
source and the object of the program are released 
internally. Howevers the source for the interpreter 
should be the most current one availabte should it need 
to be recomoiled. 


The GISMO trace table is used for accumulating the information. 
The interpreter uses the pointer to this table which is 
maintained tn HINTS. The table must be attocated at CLEAR/START 
by using a debug GISMO (CGISMO/DEBUG) and setting the appropriate 
bit to cause the system tnititalizer CSYSTEM/INIT) to atlocate a 
trace table out not request any tracing. The TG SPO command may 
also be used to achieve the same result. It 1s cructal that 
GISMO and the interpreters do not attempt to use the table at the 
Same time. Documentation on the GISMO trace table does not exist 
at the time of this writing. ; 


The table is organized as an array of 96 bit entries» with the 
first 48 bits being a time accumulator and the second &8 bits a 
frequency accumulator. 


HARQWARE REQUIREMENTS 


The high resolution timer CHRT) is a hardware device which» when 
presente is resident in a 81800/81700 I/0.base or base extension. 


It maintains a 4 8 bit counter which is updated every 
micro-seconde The HRT its not required in order to use 
INTERP/MONITOR although the program was originally designed to 
use information obtained from it. If the HRT .is not present, 


INTERP/MONITOR can be used to print out the frequencies of S-ops> 


1-3 


BURROUGHS CORPORATION : | COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP 8186090731700 INTERP/MONITOR 
SBP? IN-PLANT USE ONLY TePeSe 2219 G334 


but all times wilt be indicated as zero. (See Appendix A of this 
document for more information on the HRT.) 
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OPERATING INSTRUCTIONS 


INTERP/SMONE TOR is executed from the SPO by the follcwing 
statement. ; 


EX INTERP/MONITOR 


The program then generates an ACCEPT message to which the user 
should respond: 


<job-number>AX READ 


INTERP/MONITOR then reads a card file tabetled CARDS which 
contains .the mnemonics . associated with the S-machine bdeing 
measured. Fach mnemonic must he om a separate card and the 
mnemonics must be tn ascending Sop order. For examples» for SDL» 
successive cards would be as follows: 


LA 
ILA 
sTOO 
LIIN 
LI 
etc. 


Each mnemonic may te a maximum of six characters» may begin 
anywhere on the card» and may contain any EBCDIC character excerpt 
a blank. © If after reading the entire card file» INTERP/MONITOR 
determines that there is insufficient space in the GISMOQ trace 
table to accommodate the specified numbder of mnemaonicse the 
program will request the user to CLEAR/START’ and provide the 
values to enter in the console switches to insure sufficient 
Space. 


If sufficient space is availables the user may then execute his 
program using the special interpreter which enters values into 
the table. 
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COMMANDS 


This section contains a description of the command set cf 
INTERP/MONITOR. Commands are entered by issuing ACCEPTs to the 
program. 


Syntax? tse=- ANALYZE.«TAPEs*SINGLE =~ <print variant> -->1 
oars gia ANALYZE.TAPE ~~ <print variant> wore rrre>] 
(See the PRINT command for a description of <print variant>. 


See the DUMP.TO.TAPE and CLOSE comvancs for information on 
how ene tape is generated.) 


INTERP/MONITOR can analyze a tape in one of two ways. If the 


command entered is ANALYZE.TAPE.~SINGLE> the program prints a 
table for each separate table on the tape. If the command is 


ANALYZE.TAPE> all of the files are analyzed and the information 
merged inte one table. 


If the command is ANALYZE.TAPE then after collecting allt of the 
information from each tape» INTERP/MONITOR will ask if more tapes 
are to be accumulatad. A user response of “Y*" wiit cause 
INTERP/MONTTOR to read another tape. A user response of "N" will 
cause INTERP/MONITOR to print out the accumulated tables in the 
requested formats. The totals in this table are a simple 
accumulations there is na attempt to weigh the ‘various tables 
accunulated. . ; 
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This command clears the entire GISMG trace table to zeros. 
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CLOSE 
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After tne DUMP.TO~TAPE command has been used to dump tabtes to a 
taper this command is used to close and rewind the tape. . 
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OUMPsTO.TAPE 

Syntax?  ces--- “> DUMP.TO.TAPE ="2%22> lalate iesheketatelaiataetahetatemate >I 


This conmand causes the current contents of the GISMO trace table 
to he dumped to tape. Any number of tables may be dumped ta one 
tape since the tape remains open and not rewound after the table 
is dumpede The tape file may te closed and rewound by entering 
the CLOSE command. 
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PARAAS 

Syntax? cesrene=" PARAMS seen ne SPQ torte eta cnn e ene eneecce-- 


This option provides the user with the ability to enter 
parameters from the card reader or the SPC. (See the PRINT 
command.) If they are entered from the card readere column one cf 
the card must contain an Ir aTr or an 0 to indicate which 
parameter 1s on the card. Only one of each 18 permitted. The 


actual text must begin in column 2. 
The abbreviations indicate the following: 
“~ INTERPRETER.NAME 


I 
Toe FITce 
QO -~ TIMER.OVERHEAD 


Example of input from cards: 


1 


ISDL/TINERINT 
TSOL/COMPILER OF MCP ON SYS 805 
O06 
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syntax: ee IS ee Li sre oe “\-= <print variant> tte 3st 4+- >} 


At any times the user may enter a print command to raquest that 
the current contents of the table be printed. INTERP/SMONITOR 
makes a copy of the trace table within itself using one S~ap to 
move the values from the GISMO trace tabler thereby insuring that 
no user program can change the values in. the table while they are 
being printed. 


The table can be printed in any combination of four formats. Tt 
may be ordered by S=op»e time» frequency» or printed 
alphabetically. When the table is ordered by time or frequency 
zero entries may be suppressed by including the SUPPRESS option. 


The ALL variant will print four tablese one each by times 
‘frequencyse S-op and atphabetical. . 
Alt possible print variants are shown in the syntax below. 
<prant Ver pantse=ese>="25 RS see ee SASS res e sess >I 
f-- BY <->] 1 i 
[Cees S eas sssee sees t 
IAa CLINE  -SHs= ss =8SSe=> >I 
Deo TIMES sneer encccenn- >I 
fm" FREQUENCY eoeeccee= >| 
in-- FREQUENCIES =-*---- >4 
i== REG SS esos eee ee >| 
bo- FREQS teece tence ne- > 
$—<—- ALPHABETIC seeeweena >I 
I-~ ALPHASETICAL --~--- >4 
i=" ALPHA S22 e se ied ad >1 
bo= S.0P 0 wee nn ere enene- >4 
Pm~ S.OPS sees etre ren -->/| 
i=* SUPPRESS. Ssses ses -->] 


Pm- SUP ween eennee-->1 


[m= ALL wetter newer) 


The user 48S requested to enter the following information to be 
used In printing the table. 


INTERPRETEReNAME 


The. first 21 characters wilt be 


used tc 


identify the name of the interpreter that 


is being measured. 
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TITLE The title enterec witt be tnctuded in the 


output of the table. It tiay be up to 80 
characters in tength. 


TIMER.GVERHEAD This decimal number witk be subtracted 
from the time associated with each Sop. 
The user calculates the time required in 
the interpreter to turn the timer off and 
on between each S-ope The value entered 
will be printed an the Listing. 


The parameters specified above may be ‘entered from the card 
reader if the PARAMS option is used. (See PARAMS in this 
section. } 


Note; 


For debugging purposes» if the tleftmost bit of the 
console switches 15 oney INTERP/MCNITCR will not request 
the above information. Blanks will be assumed for 
INTERPRETER.NAME and TITLE and zero for TIMER.GVERHEAD. 
(See MCP manual for use of the SPO “SE" command.) 
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soe 

Syntax! ceresess- STOP sean c owen seen eens olatatatetatatatatatate >I 


This cemmand terminates INTERP/MONT TOR. 
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This appendix describes a B1800/81700 Hardware Module that may be 
connected to the I/0 Exchange €a standard channel) and provide a 
real time clock function. A number of variants are described 
which control the counter attributes and actions. The module 
will occupies 81860C/81700 card. 


‘The counter may be read using conventional I/0 Exchange commands 
from the processor. 


The counter can be operated as one 48 bit device or as four 12 
bit devices in order to test overflow logic. It can alsc be 
preset to a number using conventional I/0 Exchange commands. 


Counter overflows will not trigger a service request» but can be 
detected through a TEST STATUS command. 


QPERATIONS 

The descriptions of the following operations use terminology 
applicable to the 81800/81700 I/0 8US. 

Tw INITIAL CQUNT D<-SET INTO COUNTER: 

Counter is O-Set to a number by reading 24 bits during ‘each of 
two RC times. This is done, with a TRANSFER OUT B command. 


20 READ THE COUNTER:: 


Before a new count» the 48 bits are latched and can be read into 


the processor with two RC*S without stopping the counter. The 
D-Set condition of the Latches is stopped during the time the 
count is being read into the processor. All these are done with 


a TRANSFER IN. Note ~~ TRANSFER OUT to a counter does not start 
the counter» nor does TRANSFER IN stop the counter. 


36 . OTHER FUNCTIONS: 


Ae TEST: On a normal teste the unit will return status as 
well as normal 1[.D. : 
EXx08 QO for counting up 
1 for counting down 


Hf 
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EXC9 = 0 for no overflow/urcerflow tin Lowest order 


12 bit counter since Last O-Set 
1 for overflow/urnderflow occurred in Lowest 
order 12 bit counter after tast D-Set 


EXLO = 0 (same as EX99r for second 12 bit counter) 
= 1 Csame as EXO09%s for second 12 bit counter) 
EXi1 = 0 Csame as EX09s for third 12 bit counter) 
= J] (same as EXO9s for third 12 bit counter) 
EX12 = © (same as EX09r for highest order 12 bit counter) 
= 1 (Csame as EX09>» for highest order 12 bit counter) 
EX13 = 1 for four 12 bit counter configuration 
= 0 for 48-bit counter configuration 
EXi6~EX1L9 = Q001 for counter. stopped 


0010 for counter counting 


Be. TEST & CLEAR 


Same as above but also clears all logic including counter outputs 
to zero. A clear command stops the counter and sets it ina 48 
bite counting-up configuration as well as resetting the overflow 
flip-flops. The status reported during. RC time will be that of 
the counter immediately before the clear. 


C.- OPTIONS 


A TRANSFER_OUT_A operation may be used to set options in the HRT. 
At CA timer a variant indicates one of the following operations: 


EXOOrEXO02 = 000 - start counting 
O01 = stop counting 
010 = count up 
O11 = count down 
100 - counter structured as one 48 bit counter 
101 - counter structured as four 12 bit counters 


During RC time» TRANSFER_OUT_A returns status and I.Der as during 
RC time of a TEST commands. In XFRIN and XFROT@ commandse 48 bits 
of data are always transferred. Therefore» two RC times will 
always follow the CA time of either of these two commands. 
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FUNCTIONS IN DETALL 


1. READ COUNT INTO COUNTER: 


At CA timer if the channel address ts equale the TRANSFER OUT 
PHASE 8 instruction bits are strobed into the 3-bit register anc 
decoded. The command register will not be cleared until the end 
of the second RC time. Note that there exists an F/Fse RCLFs» to 
differentiate the two RC*s. With the first RC» the first 24 bits 
(“are Ow-Set into the lower part of the counter and with second RC» 
another 24 pits are D-Set into the upppershatf of the counter. 


26 READ THE COUNT OUTS 


The XFRIN command is decoded and the D-Set Mode of the latch is 
stopped. The contents of the Latch are read by two RC'S with 24 
bits each time onto the exchange lines» the lower order 24 bits 
being enabled onto the exchange Lines befcore the higher order 
bits. 


Note: The TRANSFER OUT A command is being used primarily to set 
the configuration of the counter Ceither 1x48 bits or 
4x12 bits) and to stop and start it counting either up or 
downe The TEST STATUS and TEST AND CLEAR commands are 
used to determine the counter'’s status. 


GENERAL COMMENTS ON 81700 HIGH SPEED TIMER MODULE 


It is anticipated that the Yimer Module will be an “add on" 
device and wiil not be present on all BL700"sS. AS suche jts use 
will be confined to special runs and in some cases specialized 


software’ available “in house”. Thus» for the timer portion af 
the MODULE» one 48-bit counter running at a I1MHz rate is 
sufficient. T€ additional counting functions are desirede then 


the one hardware counter can be programaticatly “gated" into ane 
or more memory buckets to provide the needed capabilities. 


From a diagnostic point of viewer the hardware is capable of 
breaking the counter tnto 4-12 bit counters» disconnecting the 
overflow Lagic between these counterser but allowing the driving Il 
MHz signal to he programmatically moved to the Low order position 
of each of the 12 bit counters. In this way» each of the 12 bit 
sections can be individually tested» including its overflowe in a 
short period of times In the 12 bit configuratione the overflon 
from each counter will set the overflow flip-flops» but will not 
feed into the next higher 12 bit counter. 
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Note: This timer module may only be used with. MCP*s of Mark 


Level 4-1 or tater and must be on Channel 15-2 The device 
120s for the module is 100000 Cbinary) which was chosen 
to insure that even if the MCF sees the devicer fr will 
ignore it since it looks like a datacomm 1.0. Howevere 
this should never occur because GIS“0 reports "MISSING 
DEVICE" for all inquirtes on Channel. 15. 
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